home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / dailydump / dailydump.man < prev    next >
Encoding:
Text File  |  1991-09-28  |  2.6 KB  |  79 lines
  1. '\" Copyright 1990 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/dailydump/RCS/dailydump.man,v 1.5 91/09/28 15:57:30 kupfer Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS DAILYDUMP cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. dailydump \- Script to do daily dumps
  17. .SH SYNOPSIS
  18. \fBdailydump\fR [\fB\-i\fR] [\fIstartFs\fR]
  19. .IP "\fIstartFs\fR" 15
  20. Start dumping with the named filesystem.
  21. .IP "\-i" 15
  22. Initialize the tape drive, remove the weekly dump lock file, and exit.
  23. .BE
  24.  
  25. .SH DESCRIPTION
  26. .PP
  27. This script does a level-1 dump of all filesystems that are normally
  28. backed up.  (A level-1 dump captures all changes since the previous
  29. level-0 dump for the given filesystem.)  It is normally invoked in the
  30. wee hours of the morning by
  31. .BR cron .
  32. .PP
  33. When the script has completed, it sends mail to the current dumper
  34. (see the man page for
  35. .BR weeklydump ), 
  36. giving the amount of free space left on the current tape.
  37. If there are detectable errors, mail is sent to the dumper with an error
  38. message.
  39. .PP
  40. There are normally two reasons for manually invoking
  41. .BR dailydump .
  42. The first is to re-enable the daily dumps after the weekly dumps have
  43. completed.  This is what the
  44. .B \-i
  45. option is for.  It ensures that the lock file used by the weekly dumps
  46. is gone, and it initializes the tape currently in the drive.  (The dumps won't
  47. actually commence until invoked by
  48. .BR cron ).
  49. .PP
  50. The other reason for invoking 
  51. .B dailydump
  52. by hand is to restart the dumps if the machine running them crashed
  53. before the dumps could finish.  In this case the user should specify the
  54. filesystem that was being dumped when the machine crashed.  The dumps
  55. will begin immediately.
  56. .PP
  57. When invoking 
  58. .BR dailydump , 
  59. be sure you're running as root.
  60.  
  61. .SH FILES
  62. All of the following files are in /sprite/admin/dump:
  63. .IP doingdaily.active 15
  64. status file used to detect crashes.  Contains the name of the host
  65. running the dumps.
  66. .IP doingweekly 15
  67. lock file to prevent daily dump from running
  68. .IP dumpdates 15
  69. list of filesystems dumped, at what time, what tape, etc.
  70. .IP dumplist 15
  71. list of filesystems to dump
  72. .IP dumplog 15
  73. very large status log from the dump programs
  74. .IP tapelist 15
  75. list of tape devices to use.  Dailydump uses the first drive on the list.
  76.  
  77. .SH KEYWORDS
  78. dump, tape, backup
  79.